Claude Code에는 슬래시(/)를 입력하여 접근할 수 있는 기본 내장 명령어들이 있지만, 자주 실행하는 반복 작업을 자동화하기 위한 커스텀 명령어를 직접 만들 수도 있습니다.

커스텀 명령어 만들기

커스텀 명령어를 만들려면 프로젝트에 특정 폴더 구조를 설정해야 합니다:

1. 프로젝트 디렉터리에서 .claude 폴더를 찾습니다
2. 그 안에 commands라는 새 디렉터리를 만듭니다
3. 원하는 명령어 이름으로 새 마크다운 파일을 만듭니다 (예: audit.md)

파일 이름이 명령어 이름이 됩니다. 예를 들어 audit.md는 /audit 명령어를 생성합니다.

예시: Audit 명령어

다음은 프로젝트 의존성의 취약점을 감사하는 커스텀 명령어의 실제 예시입니다:

이 audit 명령어는 세 가지 작업을 수행합니다:

1. npm audit을 실행하여 취약점이 있는 설치 패키지를 찾습니다
2. npm audit fix를 실행하여 업데이트를 적용합니다
3. 테스트를 실행하여 업데이트가 기존 기능을 손상시키지 않았는지 확인합니다

명령어 파일을 만든 후에는 Claude Code를 재시작해야 새 명령어가 인식됩니다.

인수를 사용하는 명령어

커스텀 명령어는 $ARGUMENTS 플레이스홀더를 사용하여 인수를 받을 수 있습니다. 이를 통해 명령어를 훨씬 더 유연하고 재사용 가능하게 만들 수 있습니다.

예를 들어, write_tests.md 명령어는 다음과 같은 내용을 담을 수 있습니다:

Write comprehensive tests for: $ARGUMENTS

Testing conventions:
* Use Vitests with React Testing Library
* Place test files in a __tests__ directory in the same folder as the source file
* Name test files as [filename].test.ts(x)
* Use @/ prefix for imports

Coverage:
* Test happy paths
* Test edge cases
* Test error states

그런 다음 파일 경로와 함께 이 명령어를 실행할 수 있습니다:

/write_tests the use-auth.ts file in the hooks directory

인수는 파일 경로일 필요가 없습니다. Claude에게 작업의 맥락과 방향을 제공하기 위해 전달하고 싶은 어떤 문자열이든 사용할 수 있습니다.

주요 장점

• 자동화 - 반복적인 워크플로우를 단일 명령어로 전환
• 일관성 - 매번 동일한 단계가 수행되도록 보장
• 맥락 제공 - 프로젝트의 특정 지침과 규칙을 Claude에게 제공
• 유연성 - 인수를 사용하여 다양한 입력에 대해 명령어 활용 가능

커스텀 명령어는 테스트 스위트 실행, 코드 배포, 팀의 규칙에 따른 보일러플레이트 생성 등 프로젝트별 워크플로우에 특히 유용합니다.